v8.0.1

Compare Source

Fixes

• Fix and document support for the {encoding: 'buffer'} option. It is the same as {encoding: null}, but preferred over it. (#​572)

v8.0.0

Compare Source

Breaking

• Require Node.js 16.17.0 and later (#​569)

v7.2.0

Compare Source

• Add cwd error property (#​565) f57fdec

v7.1.1

Compare Source

Features

• Improve error message when $.sync(options)`command` is used instead of $(options).sync`command` (#​551)

Bug fixes

• Fix argument concatenation when using $`command argument${value}` (#​553)
• Fix default value of the stdin option when using $`command`: it should be inherit (#​550)

v7.1.0

Compare Source

Features

• Add $ method to write Node.js scripts like zx. For more information, please see this blog post, this section and this page. Thanks @​aaronccasanova for this great feature!

import {$} from 'execa';

const branch = await $`git branch --show-current`;
await $`dep deploy --branch=${branch}`;

• Add .pipeStdout(), .pipeStderr() and .pipeAll() methods to redirect stdout/stderr to a file, a stream or another process.

// Similar to `echo unicorns > stdout.txt` in Bash
await execa('echo', ['unicorns']).pipeStdout('stdout.txt');

// Similar to `echo unicorns 2> stdout.txt` in Bash
await execa('echo', ['unicorns']).pipeStderr('stderr.txt');

// Similar to `echo unicorns &> stdout.txt` in Bash
await execa('echo', ['unicorns'], {all: true}).pipeAll('all.txt');

• Add inputFile option to use a file as stdin.

// Similar to `cat < stdin.txt` in Bash
const {stdout} = await execa('cat', {inputFile: 'stdin.txt'});
console.log(stdout);
//=> 'unicorns'

• Add verbose option to print each command on stderr before executing it. This can also be enabled by setting the NODE_DEBUG=execa environment variable in the current process.

> node file.js
unicorns
rainbows

> NODE_DEBUG=execa node file.js
[16:50:03.305] echo unicorns
unicorns
[16:50:03.308] echo rainbows
rainbows

v7.0.0

Compare Source

Breaking

• Require Node.js 14 and later (#​497) a09cbc0

Fixes

• Emit end event on streams when process fails (#​518) 30c7a7a
• Fix incorrect execaNode signature in index.d.ts (#​506) 1f7677c

v6.1.0

Compare Source

• Support AbortController (#​490) c6e791a
• Allow cwd and localDir options to be URLs (#​492) 93ab929

v6.0.0

Compare Source

Breaking

• Require Node.js 12.20 (#​478) 7707880
• This package is now pure ESM. Please read this.
• Moved from a default export to named exports.
  • require('execa') → import {execa} from 'execa'
  • require('execa').sync → import {execaSync} from 'execa'
  • require('execa').command → import {execaCommand} from 'execa'
  • require('execa').commandSync → import {execaCommandSync} from 'execa'
  • require('execa').node → import {execaNode} from 'execa'